HP ADVISE
Software Migration Tool

{Figure: illustration (flow chart)]

Product Overview
HP ADVISE is a migration tool designed to help software developers port
applications from Domain/OS to a standards-based environment. It enables
software developers to more easily port applications to the HP-UX Series
700 workstations.
   HP Advise can be used to determine the extent of changes required to
port Domain applications; it also recommends standard interfaces to use
in the porting effort. As a result, it is ideal for Domain users who
have many internally developed applications to be ported to HP-UX.
Through HP's Open Migration Program, HP ADVISE is also available as part
of a consulting service to help customers scope and plan their porting
activities.
   HP ADVISE has several components, grouped into three toolsets. They
are the Source Code Scanner, Open Systems Programming Guide, and GPR-to-
X conversion utilities.
Source Code Scanner
The Source Code Scanner consists of executables to scan C, Fortran, and
Domain Pascal* source code, a set of databases containing hints which
flag non-standard system and library calls, and documentation. The
documentation contains instructions on the use of the tool-set,
principles and techniques for porting programs from Domain to open-
systems compliance and HP-UX to open-systems compliance. In addition,
example code is included to demonstrate the process of porting six
Domain-specific programs to open-systems compliance. The examples focus
on commonly used Domain subsystems.
   The Source Code Scanner uses databases to specify which Domain
functions to scan for and which standards to use when recommending
alternatives. The data-bases are used to search for and recommend
changes for Domain-specific system calls and include files. Note that
the scanner identifies system calls but does not check the call
parameters.
   The porting guides document the changes required when porting from
Domain/OS to a standards-based operating system. The guides provide
information on the alternatives recommended by the Source Code Scanner
and also address those areas for which there are no one-on-one
replacements for Domain calls.

* Pascal functions are available on all Domain and HP-UX platforms
except Series 400 HP-UX.

Open Systems Programming Guide
The Open Systems Programming Guide is a third-party book on programming
techniques and suggestions for writing POSIX.1-compliant programs.
GPR-to-X Conversion Utilities
The GPR-to-X conversion toolset consists of source code and make-files
for building the GPR-to-X conversion library, a book on porting code
from GPR-to-X, documentation on building and using the GPR-to-X
conversion library, and release notes.
   The graphics porting guides provide advice on how to program to the
industry-standard X Window System to make source code portable. They
also provide specific advice for Domain GPR calls that do not have a one-
to-one correspondence with standard X calls.
   The graphics conversion library is sample source code that implements
80% of the GPR calls using X Windows. This library can be used as an
example of how to implement GPR functions in X Windows and can also be
compiled to provide a temporary emulation solution.
HP ADVISE Highlights
o Supports commonly used stan-dard languages such as C, Fortran, and
Pascal sources
o Checks for standards compliance to insure that coding complies with
industry-supported standards (ANSI C, XPG3, POSIX.1, FIPS 151-1, and OSF
AES)
o Offers System Call Mapping for advice on which standard system calls
to use to replace proprietary Domain calls
o Provides Include File Mapping for advice on which standard include
files to use to replace proprietary Domain include files
o Includes Domain GPR Mapping for advice on which X Window graphics
calls to use to replace Domain GPR calls
o Provides System Porting Guides for advice on how to program to
industry standards, to make source code portable
o Provides specific advice for Domain system calls that do not have a
one-to-one correspondence with standard calls
Configuration Information
HP ADVISE runs on Domain/OS and HP-UX workstations. It supports the
following hardware and software systems.
 Domain Hardware:
   Series 400: Models 400, 425, 433
   DN Series: Models 3000, 4000, 2500, 3500, 4500, 5500, 10000
 HP-UX Hardware
   Series 400: Models 400, 425, 433
   Series 700: All Models
 Memory:
   at least 8MB of total system RAM
 Software:
   Domain/OS SR10.3.5 and up
   HP-UX 8.07 and up
HP ADVISE includes:
 Source Code Scanner
 Domain-to-Standards Databases
 Standards Verification Databases
 GPR-to-X Databases
 GPR-to-X Sample Program
 License Certificate for Domain/OS or HP-UX
Documentation:
 On-line Documentation
 Release Notes
 Extensive Porting Examples
 Porting to POSIX Guide
 Domain/OS to Standards Guide
 Domain GPR-to-X Windows Guide
 GPR to Xlib Emulation Guide
For more information, contact any of our worldwide sales offices or HP
Channel Partners. (In the U.S., call 1-800-637-7740; in Canada, call 1-
800-387-3867.)
The information contained in this document is subject to change without
notice.
Copyright (c) Hewlett-Packard 1993
Printed in U.S.A. 2/93
5091-7151E